home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 501-525 / disk_510 / atcopy / docs / manual < prev    next >
Text File  |  1992-05-06  |  11KB  |  243 lines
  1.           ATCopy2.22  (c) Copyright 1991 by Peter Vorwerk    ATCopy2.22
  2.  
  3.           -------------------------------------------------------------
  4.  
  5.           Bugfixing to version 2.21:
  6.  
  7.           In version 2.21 it could sometimes happen, that instead to
  8.           open the filerequester, the program crashed. This bug have
  9.           been fixed. This is the last SHAREWARE version. A new
  10.           comercial version is obtainable by the author or by
  11.  
  12.                            T  r  i  C  o  m
  13.                            Andreas   Küster
  14.                            Geibelstraße  14
  15.                            3000  Hannover 1
  16.  
  17.                            G E R M A N Y
  18.  
  19.           The SHAREWARE will be calculated, if you buy the new version
  20.           directly from the author.
  21.  
  22.           -------------------------------------------------------------
  23.  
  24.           Bugfixing to version 2.2:
  25.  
  26.           Now the XT-Board and the SideCar are recognized correct.
  27.           This feature should have worked a long time ago,
  28.           but it didn't.
  29.  
  30.           -------------------------------------------------------------
  31.  
  32.           Bugfixing to version 2.1:
  33.  
  34.           In version 2.1 the conversion of national chars won't
  35.           work properly. In fact they wont't work at all. Now this
  36.           bug has been fixed.
  37.  
  38.           New in version 2.2:
  39.  
  40.           The options and the PC path now can be changed by
  41.           gadgets. These gadgets will show the defaults you
  42.           have specified by CLI. If you click one gadget twice it
  43.           will turn off. ATTENTION: By a refreshing error the string
  44.           gadget for the PC path seems to have no cursor after you
  45.           have clicked it. But it will be active! The options mean
  46.           exactly the same as in the programs AREAD and AWRITE on
  47.           the XT/AT board.
  48.  
  49.           If you specify an non existing drawer on the
  50.           XT/AT side it will be generated first. But at
  51.           least the parent of this must already exist.
  52.  
  53.           In this version the program will show an Alert, if you try
  54.           to write to an write-protect or an full disk. Maybe
  55.           this will change in a new version.
  56.  
  57.           The new patch program will work with both new
  58.           versions of ATCopy.
  59.  
  60.           With the program 'Patch_Option' you can modify
  61.           the 'default' option. This can be done by
  62.  
  63.           Patch_Option ATCopy opt [path]
  64.  
  65.           With this program you can modify ATCopy2.2 to
  66.           work with your own defaults if you don't select
  67.           any by CLI or WB.
  68.  
  69.           The ORGINAL manual for the new requester is
  70.           included. Please read this manual, especialy for
  71.           EXTENDET SELECT MODE. This mode is supported.
  72.  
  73.           This filerequester ist (c) 1990 by Khalid Aldoseri.
  74.  
  75.           Thanks to Oliver Denzler for the new icon.
  76.  
  77.           Also thanks to all those sending bugreports, improvements
  78.           or money. This helped me to update the program.
  79.  
  80.           Known Bug: If you call the program from workbench, you will
  81.           lose 24 Bytes of memory. If you use the CLI, this won't
  82.           happen. I can't fix this bug.
  83.  
  84.           -------------------------------------------------------------
  85.  
  86.           New in version 2.1:
  87.  
  88.           Now you will find two versions of the program
  89.           ATCopy2.1. These two versions differ only in the
  90.           messages. One will print these in english and
  91.           the other in german.
  92.  
  93.           In the new  version 2.1 the  length of  a file will no longer
  94.           change if you use the OPT B option.  This caused some trouble
  95.           if you use compressed files.  Thangs to  Jeff Christensen for
  96.           reporting this bug.
  97.  
  98.           -------------------------------------------------------------
  99.  
  100.           The program  ATCopy2.0 is  an update for the version 1.0. But
  101.           this new version is SHAREWARE instead of PD. If you find this
  102.           program  useful  and  use  it  regular,  please send $10 ( or
  103.           DM 10 ) to the follow address.
  104.  
  105.                     Peter Vorwerk
  106.                     Jägerstr. 3-5
  107.  
  108.                     (W) 3000 Hannover 1
  109.                     Germany
  110.  
  111.           The program may be distributed for non-profit only  ( a price
  112.           of more  than $7  per disk    is   surely no more a self cost
  113.           price ! ) and this manual is  also copied.  ( You are allowed
  114.           to copy  only the program without the manual to your harddisk
  115.           or your workdisk, but you are not permitted to distribute the
  116.           software in this form! ) If you want to include this software
  117.           in an other library,  than in  the one  of Fred  Fish, please
  118.           contact me frist.
  119.  
  120.           Surely everyone,  who has  an Amiga with an XT/AT Board ( the
  121.           older SideCar works well  too ), knows  it is  principle pos-
  122.           sible to copy files between the two computers. But the way to
  123.           do this is not very comfortable.  In the  new version  of the
  124.           Janus.library  ( 2.63  respectively  33.1 ) you can use wild-
  125.           cards, but only in one  direction  ( from  the  XT/AT  to the
  126.           Amiga ). Let's  say you  want to  copy several files from the
  127.           Amiga to the XT/AT, you have to copy each file seperatly. The
  128.           first relase  of ATCopy  produced a scriptfile with the sepe-
  129.           rate commands. Now we skip this step and  translate the files
  130.           directly through the socalled Dual-Ported-RAM.The program has
  131.           an icon and can be startet from the  workbench. If  you start
  132.           the program  without any  parameters, the files will be asked
  133.           for interactiv by the well known  ARP-Filerequester. From the
  134.           CLI you  are able  to specify  beside the filenames two other
  135.           parameters.
  136.  
  137.                USAGE: ATCopy Files...,TO/K,OPT/K
  138.  
  139.           Files...  means a list of filenames, the keyword
  140.  
  141.           TO        specify the PC-path  ( for  example  <TO  A:> means
  142.                     that all  files are  send to the floppy A: . If you
  143.                     don't specify the keyword  TO,  the  files  will be
  144.                     send  to  the  current  PC-path. )  and  after  the
  145.                     keyword
  146.  
  147.           OPT       you can specify one ( and only one ) of the follow-
  148.                     ing options.
  149.  
  150.                B    Translate  the  files  binary  ( no  conversion  of
  151.                     characters  and  CR's  will  not  be  translated in
  152.                     CRLF's. )
  153.  
  154.                CR   Translate the  files with conversion of characters,
  155.                     but also CR's will not be translated in CRLF'.
  156.  
  157.                NC   Translate  the  files  binary  and  CR's   will  be
  158.                     translated in CRLF's.
  159.  
  160.           The keywords TO and/or OPT MUST be typed! You can't type '/B'
  161.           to transfer files binary. Please note also, that you are not
  162.           able to type files after any option. The PC path is an option
  163.           too. So if you type:
  164.  
  165.               ATCopy file1 TO C: OPT B file2
  166.  
  167.           only 'file1' will be copied to c: binary, but not 'file2'.
  168.  
  169.           If you don't specify the keyword OPT the files will be trans-
  170.           lated by full conversion. This means both conversion of char-
  171.           acters and CR's will be translated in CRLF's. This is the way
  172.           the new programs  AREAD  and  AWRITE  work.  These  files are
  173.           distributed by Commodore with the XT/AT Board. If you use the
  174.           program  ATCopy  from  the  workbench  you  can't  ( at  this
  175.           time ? ) use  the keywords  TO and  OPT. The program uses the
  176.           standards ( current directory and full conversion ).
  177.  
  178.           INSTALLATION
  179.  
  180.           On the disk you will  find a  subdirectory  called  PC.  This
  181.           directory   contains  three   programs   AT.EXE,  XT.EXE  and
  182.           PCCOPY.EXE.  At least  two of these programs you must copy by
  183.  
  184.                AREAD DF0:ATCopy/PC/name.EXE A:name.EXE /B
  185.  
  186.           to  the  XT/AT.  In  each  case  you  will  need  the program
  187.           PCCOPY.EXE and  it depends  on your  board the file XT.EXE or
  188.           AT.EXE ( who had thought this ? ). The program  PCCOPY.EXE is
  189.           memoryresident and  need start  only once, for example in the
  190.           AUTOEXEC.BAT ( this is the  Startup-Sequence of  the XT/AT ).
  191.           The  programs  XT.EXE  and  AT.EXE  are  called  by the Amiga
  192.           program ATCopy. Therefore it is necessary  that at  this time
  193.           no program  is running.  You are  in the CLI of the XT/AT and
  194.           you are able to start a new program.
  195.  
  196.           The usage  from the  Amiga is already descripted above and so
  197.           it's not necessary to repeat it again.
  198.  
  199.           NOTE:     The  program  needs  the   ARP.library  ( at  least
  200.                     version 39. ).
  201.  
  202.           Please  notice  that  on  an  XT/AT  you  can't  use  all the
  203.           characters in filenames that are available for the  Amiga. In
  204.           fact the  space, nationalcharacters  or the  sqare braces are
  205.           not supported.  Please  notice  that  also  there  are strict
  206.           limitations in  the lenght of the filename and the extension.
  207.           Only one extension with 3 characters and 8  characters before
  208.           the  dot  "."  are  allowed. You can't use filenames starting
  209.           with a dot. so ".info" is no legal filename and the two names
  210.           "DemoDatei.info" and  "DEMODATE.INF" specify the same file on
  211.           an XT/AT !
  212.  
  213.           Everyone who has paid the SHAREWARE will get updates as quick
  214.           as possible and  even can get  the soure if  he/she wants it.
  215.           Please give me a short description of your environment.I need
  216.           this because if the program wont work in a special enviroment
  217.           it is easyer for  me to send  the new version first to  these
  218.           people who have this special environment.
  219.  
  220.           Bugreports or improvements are welcome.
  221.  
  222.           I hope  that the  translation from  the Amiga to the XT/AT is
  223.           easyer using this program.
  224.  
  225.           My program  uses parts  of  the  ARP.library  ( especialy the
  226.           GADS  routine ).  Without this  help  it had  been ( nearly )
  227.           impossible  to  write   the  program.   I'm  sorry,  but  the
  228.           informations on the Janus.library are very rare. Therefore it
  229.           can be that the program ATCopy doesn't work  in all parts  on
  230.           all configurations.  ( I have  tested it on my own Amiga 2000
  231.           with AT Board and on an Amiga 1000 with SideCar. I don't have
  232.           access to an XT Board. )
  233.  
  234.           P.S. There  is  one  more  limitation by starting the program
  235.                from the workbench. You can't specify more than one TOOL
  236.                by "SHIFT Left Mouse". The first TOOL will work with all
  237.                the PROJECTS  you have specified and  the reminder TOOLS
  238.                will be skiped.
  239.  
  240.                Solution: Don't specify any files by "SHIFT Left Mouse".
  241.                          The program will ask you for each file  by the
  242.                          Filerequester.
  243.